
Exhibit A 



Communication Drivers 

The Microsoft Windows communications driver provides a set of functions that Windows can use to 
open communication ports, set communication configurations, read and write characters, and retrieve 
error and status information. This topic describes the communication-driver functions. 

The following topics provide useful infomnation about the communication driver: 
About the Communications Driver 
Base Address and IRQ Selection 
16550a UART FIFO Buffer 

CommWriteStrinq and EnableNotification Functions 
Communication Escapes 
Baud Rate Indexes 

Communication Functions and Structures 




About the Communications Driver 

The communication driver is a dynamic-link library (DLL) containing functions that support opening 
reading from, and writing to communications devices. Although the communication driver exports ' 
several functions. Windows-based applications do not directly call these functions. Instead the 
applications call functions in the USER module, such as the OpenComm function, which in turn call the 
communications driver. 

Unlike other Windows-based drivers, the communications driver does not include the Enable and 
Disable functions, although it does include the WEP function. 



Base Address and IRQ Selection 

The Windows 3.1 communications driver (COMM.DRV) accesses serial ports COM 1 COM2 COM3 
and COM4 using base-address values specified in the BIOS data area of a computer If the BIOS data 
area does not specify values for physical ports. Windows 3.1 will use the base address 0x03E8 and 
IRQ4 for COM3, but the base addresses and IRQs for the other ports must be set by the user. 

If the BIOS data area does not specify a value for a physical port, the user can set the base address 
and IRQ values using Control Panel. Control Panel displays an Advanced settings dialog box for each 
port. The dialog box contains a selection box for base addresses and spin controls for IRQ settings 
Ivo^l'ffl!?^f'"®^ recorded as COMxBase and COMxIRQ settings in the [386EnhJ section of the 

oYbTEM.INI file. 

The COMxBase and COMxIRQ settings are used for both standard- and 386 enhanced-mode 
operation. The COMxBase setting is used only if the BIOS data area does not specify a value for the 
port; this setting never overrides the BIOS data area values. 



16550a UART FIFO Buffer 

If a computer uses the 16550a Universal Asynchronous Receiver Transmitter (UART) for its 
communication ports, the communications driver wiW enable the onboard 16-byte first in first out (FIFO) 
buffer allowing Windows to perfomn reliable serial communications at speeds of 9600 baud and higher 
(Many computers that do not enable this buffer experience loss of characters at 9600 baud and most 
cannot communicate at speeds higher than 9600 baud.) 

Before enabling the FIFO buffer, the communications driver checks the SYSTEM INI file to determine 

fn"rP' ^""^^"^ "^^^ COMxFIFO settings in the [386Enh] section of the 

SYSTEM.INI file specify whether the buffer for a given port should be enabled or disabled If the value 
of the setting is 1 . the driver enables the FIFO buffer; otherwise, it disables the buffer If no settina is 
specified, the driver will enable the buffer by default. 

The virtual-communications device (VCD) does not virtualize the 16550a for non-Windows applications. 



CommWriteString and EnableNotification Functions 

The communications driver exports the CommWriteString and EnableNotification functions The 
CommWriteString function writes a string of one or more bytes to the given communications device. 
The EnableNotification function enables or disables port status notifications. If notifications are 
enabled, the communications driver posts a WM_COMMNOTIFY message to a given window on 
certain events. This eliminates the need for communications applications to set timers and use the 
GetCommError, GetCommEventMask, and SetCommEventMask functions to monitor port status 
changes. 



int CommWriteStrjng(c/cy, pbuf, size) 



int cid; 
LPSTR pbuf; 
int size; 

The CommWriteString function transmits a string of characters using the specified communications 
device. USER calls this function whenever an application calls the WriteComm function (USER.205). 

Parameter Description 

cid Identifies the communication device. 

pbuf Points to the buffer containing the bytes to write. 

size Specifies the number of bytes to write. 

Returns 

The retum value is the number of bytes actually written. 
Comments 

The export ordinal for this function is 19. 

During initialization, USER checks for this function to determine whether the driver supports the 
extended functions new to Windows S.llf the function is not present, Windows assumes that the 
dnver is a Windows 3.0 driver and makes sure that all interaction with the driver is compatible with 
Windows 3.0. 



int EnableNotification(c/d, hWnd, wlnTrigger, wOutThgger) 
int cid; 

HWND hWnd; 
WORD wlnThggen 
WORD wOutTriggen 



The EnableNotification function enables or disables communications message posting When 
enabled, the driver posts the WM_COMMNOTIFY message to the specified window, USER calls this 
function when an application calls the EnableCommNotification function (USER.245). 
Parameter Description 



cid 

hWnd 

WlnTrigger 

wOutTrigger 

Returns 



Identifies the communication device. 

Identifies the window to receive the WM_COMMNOTIFY message. If this parameter is 
NULL, the function disables the notification. 

Specifies the minimum number of bytes to be received in the communication device's 
input buffer before receive notification is sent. 

Specifies the maximum number of bytes to remain in the communication device's 
output buffer before transmit notification is sent 



The return value is TRUE if successful. Othenvise, the return value is FALSE. 
Comments 

The export ordinal for this function is 100. 

The WM_COMMNOTIFY message has the following parameters. 



Parameter 



Description 



wParam 

HIWORD(/param) 
LOWORD(/param) 



Specifies the communication-device identifier (the cid parameter). 
Not used; must be zero. 

Specifies the notification status. It can be one of the following values 

Value Meaning 

CN EVENT 



CN RECEIVE 



CN_TRANSMIT 



An event enabled in the communication device's event 
mask (specified by the SetCommEventMask function) has 
occurred. The application should call the function 
GetCommEventMask to determine what event has 
occurred, and to clear the event 

This status is sent when the communication device's event 
word changes. The application clears the appropriate event 
to ensure notification on subsequent events. 
At least wlr)Thgger bytes are in the communication 
device's input buffer, or at least 1 byte is in the input buffer. 
Additionally, no more have been received before the end of 
an internal timeout period. The number of bytes in the input 
buffer must be lower than wlnTrigger bytes before this 
message will be sent again. 

Fewer than wOutTrigger bytes remain in the 
communication device's output buffer to be transmitted. 
The number of bytes in the output buffer must exceed 
wOutTrigger bytes before this message will be sent again. 



The communication device event may be a line-status or printer en-or. Applications can determine the 
cause by using the GetCommError function immediately after the GetCommEventMask function 



(USER.209). 



Int CommWriteString(c/cf, pbuf, size) 

int cid; 
LPSTR pbuf; 
int size; 



The CommWriteString function transmits a string of characters using the specified communications 
device. USER calls this function whenever an application calls the WriteComm function (USER.205). 

Parameter Description 

C'cf Identifies the communication device. 

pbuf Points to the buffer containing the bytes to write. 

size Specifies the number of bytes to write. 

Returns 

The return value is the number of bytes actually written. 
Comments 

The export ordinal for this function is 19. 

During initialization, USER checks for this function to determine whether the driver supports the 
extended functions new to Windows 3. 1 . If the function is not present, Windows assumes that the 
dnver is a Windows 3.0 driver and makes sure that all interaction with the driver is compatible with 
Windows 3.0. 



Communication Escapes 

The communications driver supports the RESETDEV, GETBASEIRQ, GETMAXLPT and 
GETMAXCOM communication escapes in its cextfcn function. These communication escapes reset 
the pnnter (assert the reset line) and retrieve parallel- and serial-port identifiers 



Baud-Rate Indexes 

The communications driver supports very high baud rates, such as 128.000 and 256 000 by 
interpreting the BaudRate member of the DCB structure as a baud-rate index whenever the high byte 
of the member is OxFF. In such cases. BaudRate can be one of the following values. 
BaudRate Value 

110 CBR_110(0xFF10) ~ ' 

300 CBR_300(0xFF11) 
600 CBR_600(0xFF12) 
1200 CBR_1200(0xFF13) 
2400 CBR_2400 (OxFF14) 

4800 CBR_4800(0xFF15) 
9600 CBR_9600 (0xFF16) 

14.400 CBR_14400(0xFF17) 
19.200 CBR_19200(OxFF18) 
38.400 CBR_38400(0xFF1B) 
56.000 CBR_56000(0xFF1F) 
128.000 CBRJ 28000 (0xFF23) 
256.000 CBR_256000 (0xFF27) 

Note The CBR_ values are for standardization; drivers are not required to support all indexed baud rates. 



If the high byte of the BaudRate member is not OxFF. BaudRate specifies the actual baud rate for the 
communications device. In other words, values in the range 2 through 65,279 (OxFEFF) are interpreted 
as baud rate values not as indexes. This ensures compatibility with existing communications drivers 
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typedef struct { 
char Id; /* internal device ID 

ushort Baudrate; /* operating speed 7 
char ByteSize; /* transmit/receive byte size 7 
char Parity; r 0,1,2.3, or 4 7 
char StopBits; T number of stop bits 7 
ushort RIsTimeout; /* timeout for RLSD to be set 
ushort CtsTimeout; /* timeout for CTS to be set 
ushort DsrTimeout; /* timeout for DSR to be set 
ushort fBinary: 1 ; /* binary-mode flag 7 
ushort fRtsDisable: 1 ; /* disable RTS 7 
ushort fParity: 1 ; /* enable parity checking 7 
ushort fDummy: 5; 

ushort fOutX: 1 ; /* enable output XON/XOFF 
ushort fInX: 1; /* enable input XON/XOFF 7 
ushort fPeChar 1 ; r enable parity-en^or replacement 7 
ushort fNull: 1 ; /* enable null stripping 7 
ushort fChEvt 1 ; /* enable Rx character event 
ushort fDtrflow: 1 ; r enable DTR flow control 
ushort fRtsfiow: 1 ; /* enable RTS flow control 
ushort fDummy2: 1; 

/* transmit/receive XON character 7 
/* transmit/receive XOFF character 7 
r transmit XON threshold 7 
r transmit XOFF threshold 7 
/* parity error replacement character 7 
/* end-of-input character 7 
/* event-generating character 7 
/* amount of time between characters 



7 
7 
7 



char XonChar; 
char XoffChar; 
ushort XonLim; 
ushort XoffLim; 
char PeChar; 
char EofChar, 
char EvtChar; 

ushort TxDelay; /- amount of time between characters 7 
}DCB; 

The DCB structure contains the RS-232 configuration parameters for a communication device. 
Memb er Description 



Id 



Baudrate 
ByteSize 
Parity 



Specifies the device ID byte {C0M1 = 0. COM2 = 1, and so on). This is also the 
value returned by the cOpen function, when successful. 
Specifies the operating speed; any baud rate supported by the hardware. 
Specifies the transmitting and receiving byte size; nomially in the range 4 through 8. 
Specifies the parity setting. The value can be one of the following values. 
Value Meaning 



0 
1 
2 
3 
4 



StopBits 



None 

Odd 

Even 

Mark 

Space 



Specifies the number of stop bits. The value can be one of the following values. 
Value Meaning 



RIsTimeout 



0 1 stop bit 

1 1.5 stop bits 

2 2 stop bits 

Specifies the amount of time, in milliseconds, to wait for receiving-line-signal detect 



CtsTimeout 
DsrTimeout 
fBinary 
fRtsDisable 



fParity 
fOutX 



flnX 

fPeChar 

fNull 
fChEvt 

fDtrFlow 

fRtsflow 

XonChar 
XoffChar 
XonLim 

XoffLim 

PeChar 
EofChar 
EvtChar 
TxDelay 



(RLSD) to become high. RLSD flow control can be achieved by specifyinq infinite 
timeout (OxFFFF). 

Specifies the amount of time, in milliseconds, to wait for clear-to-send signal (CTS) 
to become high. CTS flow control can be achieved by specifying infinite timeout 
(OxFFFF). 

Specifies the amount of fime, in milliseconds, to wait for data-set-ready (DSR) to 
become high, DSR flow control can be achieved by specifyinq infinite timeout 
(OxFFFF). ^ ^ 

Specifies the binary-mode flag (0 is ASCII mode, 1 is binary). In ASCII mode the 
end-of-file character (EOFCHAR) is recognized and remembered as the end'of 
received data. 

Disables the receive-transmission signal (RTS) line for as long as this device is 
open, if set. Normally. RTS is enabled when the device is opened and disabled when 
closed. 

Enables parity checking, if set. 

Indicates that XON/XOFF flow control is to be used during transmission, if set. The 
transmitter halts when it receives an XOFF character, and starts again when it 
receives an XON character. 

Indicates that XON/XOFF flow control is to be used during reception, if set. 
Indicates that characters received with parity errors are to be replaced with the 
specified parity-checking characters (PECHAR), if set. 
Specifies that the received null characters are to be discarded, if set. 

Indicates that the reception of event-checking characters (EVTCHAR) are to be 
flagged as an event, if set. 

Indicates that the data-terminal-ready signal (DTR) is to be used for receive flow 
control, if set. 

Indicates that the receive-transmission signal (RTS) is to be used for receive flow 
control, if set. 

Specifies the XON character for both transmit and receive. 
Specifies the XOFF character for both transmit and receive. 
Specifies the threshold value for receive queue. When the receive queue comes 
within 10 characters of being full, it transmits an XOFF character. When the queue 
comes within 10 characters of being empty, an XON character will be transmitted. 
Specifies the threshold value for send queue. When the number of characters in the 
receive queue exceeds this value, an XOFF character is sent (if XOFF flow control is 
enabled) and the data-terminal-ready signal (DTR) is dropped (if enabled). 
Specifies the character to be used as replacement when a parity error occurs. 
Specifies the character that signals the end of the input. 
Specifies the character that triggers an event flag. 

Specifies the minimum amount of time that must pass between transmission of 
characters. 



See Also 



getdcb, inlcom, setcom 



Communication-Driver 

cclrbrk 

cevt 

cevtGet 

cextfcn 

cflush 

CommWriteString 

csetbrk 

ctx 

EnableNotification 

qetdcb 

inicom 

ReactivateOpenCommPorts 

reccom 

setcom 

setque 

sndcom 

stacom 

SuspendOpenCommPorts 

trmcom 

COMSTAT 

DCB 

qdb 



Functions 

Restore transmission 

Sets the event mask 

Retrieves the event mask 

Carry out extended function 

Flushes queues 

Transmits a string of bytes 

Breaks transmission 

Transmit immediately 

Enable/disables communication notification 

Retrieves device-control block 

Initialize communications device 

Reactivates communications ports 

Read a byte 

Set communications block 

Set transmit and recieve queues 

Transmit a byte 

Retrieves error code and device status 
Suspends communications ports 
Closes the device 
Communications Status Structure 
Device Control Block Structure 
Queue Definition Block 



int cclrbrk(c/cO 

mt cid; 



The cclrbrk function restores character transmission and places the communications device in a 
mcco o^!^^^^ ^^^^ ^"^ ^^'^ function whenever an application calls the ClearCommBreak function 



The return value is zero if the function is successful. Otherwise, the return value returns -1. 
Comments 

The export ordinal for this function is 14. 

See Also 

csetbrk 



{USER,211). 

Parameter 

cid 



Description 



Identifies the communications device. 



Returns 



LPWORD cevt(c/d, evtmask) 

int cid; 

int evtmask; 



The cevt function enables events in the event mask of the specified communications device USER 
calls this function whenever an application calls the SetCommEventMask function {USER.208). 
Parameter Description 

cid 

evtmask 



Identifies the communications device. 

Specifies which events are to be enabled. This parameter can be any combination of 
the following values. 

Value Meaning 

EV_BREAK 
EVICTS 
EV^DSR 
ERR 



EV 



EV_PERR 

EV_RING 

EV_RLSD 
EV_RXCHAR 

EV_RXFLAG 



EV_TXEMPTY 



Enables detection of a break upon input. 
Enables detection of the clear-to-send (CTS) signal. 
Enables detection of the data-set-ready (DSR) signal. 
Enables detection of a line-status en^or Line-status errors are 
CE_FRAME. CE_OVERRUN. and CE_RXPARITY. 
Enables detection of a printer en^or on a parallel device. Errors are 
CE_DNS, CEJOE. CE_LOOP, and CE.PTO. 
Indicates the state of ring indicator during the last modem intenupt. 
(Use EV^RINGTE to detect when a phone ring has occurred.) 
Enables detection of the receive-line-signal-detect (RLSD) signal. 
Enables detection of any character received and placed in the 
receive queue. 

Enables detection of the event character received and placed in the 
receive queue. The event character is specified in the EvtChar 
member of the DCB structure. 

Enables detection of when the last character in the transmit queue is 
sent. 



Returns 

The retum value is a pointer to a 16-bit buffer if the function is successful. Otherwise the function 
returns zero if there is an enror. 

Comments 

The export ordinal for this function is 1 1. 

The communications driver sets one or more bits in the returned buffer whenever one of the events 
specified by the evtmask parameter occurs. 



WORD cevtGet(c/d, evtmask) 

int cid; 

int evtmask; 



The cevtGet function retrieves and then clears the event mask for a communications device USFR 
calls this function whenever an application calls the GetCommEventMask Sr'us^^^^^^^ 
Parameter Description 



cid 

evtmask 



Identifies the communications device^ ' ~ 

Specifies which events in the current event mask to disable. This parameter can be anv 
combination of the following values. pciidmeier can oe any 



Value 



EV_BREAK 
EV_CTS 
EV_DSR 
EV_ERR 

EV_PERR 

EV_RING 

EV_RLSD 
EV_RXCHAR 

EV_RXFLAG 



EV_TXEMPTY 



Meaning 



Enables detection of a break upon input. 
Enables detection of the clear-to-send (CTS) signal. 
Enables detection of the data-set-ready (DSR) signal. 
Enables detection of a line-status error. Line-status errors are 
CE_FRAME. CE_OVERRUN. and CE_RXPARITY. 

S!fo^^!P*!2!' °^ ^ P""*®^ °" a parallel device. Errors are 
CE_DNS, CEJOE. CE_LOOP, and CE_PTO. 

Indicates the state of ring indicator during the last modem interrupt. 
(Use EV_RINGTE to detect when a phone ring has occurred.) 
Enables detection of the receive-line-signal-detect (RLSD) signal. 
Enables detection of any character received and placed in the 
receive queue. 

Enables detection of the event character received and placed in the 
receive queue. The event character is specified in the EvtChar 
member of the DCB structure. 

Enables detection of when the last character in the transmit queue is 

seni. 



Returns 

The return value is the current event word as set by the cevt function. 
Comments 

The export ordinal for this function is 12. 
See Also 



cevt 



LONG cextfcn(c/d, fen); 

int cid; 
int fen; 



The cextfcn function carries out the extended communications function specified by the fen parameter 
USER calls this function when an application calls the EscapeCommFunction function (USER.214). 
Parameter Description 



eid 
fen 



Identifies the communications device. 

Specifies the extended function to carry out. It can be one of the following values. 

Value Meaning 

CLRDTR ^ 
CLRRTS 
GETBASEIRQ 



GETMAXBAUD 



GETIMAXCOM 



GETMAXLPT 

RESETDEV 

SETDTR 
SETRTS 



Clears the data-tenninal-ready (DTR) signal. 
Clears the request-to-send (RTS) signal. 
Returns the base-port address and IRQ setting for the COM port 
specified by the eid parameter. The low 16 bits of the return 
address specifies the base-port address, and the high address 
specifies the IRQ selection. If the high 16 bits is -1. then the port 
does not exist; if it is zero, the installed COMM driver does not 
support this escape. 

Returns a constant that indicates the highest baud rate supported 
by the port specified by the eid parameter. The following constants 
may be returned. 

Value Meaning 



CBRJ10 

CBR_300 

CBR_600 

CBR_1200 

CBR_2400 

CBR_4800 

CBR_9600 

CBR_19200 

CBR_38400 

CBR_56000 

CBR_1 28000 

CBR 256000 



The highest baud rate is 1 10. 
The highest baud rate is 300. 
The highest baud rate is 600. 
The highest baud rate is 1200. 
The highest baud rate is 2400. 
The highest baud rate is 4800. 
The highest baud rate is 9600. 
The highest baud rate is 19,200. 
The highest baud rate is 38,400. 
The highest baud rate is 56.000. 
The highest baud rate is 128,000. 
The highest baud rate is 256,000. 
Retums the maximum COM port identifier supported by the 
communications driver. This value ranges from 0x00 to 0x7F such 
that 0x00 corresponds to COM1, 0x01 to COM2, 0x02 to COM3, 
and so on. The communications driver included in Windows 3.1 ' 
supports C0M1 through COM4, and will always retum 0x03. 
Retums the maximum LPT port ID supported by the system. This 
value ranges from 0x80H to OxFFH. such that 0x80H corresponds 
to LPT1. 0x81 H to LPT2. 0x82H to LPT3, and so on. 
Resets the printer device (that is, assert the reset line) if the cid 
parameter specifies an LPT port. No function is performed if eid 
specifies a COM port. 

Sets the data-tenninal-ready (DTR) control line on. 
Sets the request-to-send (RTS) control line on. 



Causes transmission to act as if an XOFF character has been 
received. 

Causes transmission to act as if an XON character has been 
received. 

Returns 

This return value is zero if successful. Othenwise. it is negative if the fen parameter does not specify a 
valid function code. 

Comments 

The export ordinal for this function is 9. 

If the communications driver does not export the CommWrfteStrina function, Windows 3 1 intercepts 
and adjusts the return values for the GETBASEIRQ, GETMAXBAUD. GETMAXLPT, and 
GETMAXCOM functions after the cextfcn function returns. 



SETXOFF 
SETXON 



LONG cextfcn(c/d, fen); 



int cid; 
int fen; 



The cextfcn function carries out the extended communications function specified by the fen parameter. 
USER calls this function when an application calls the EscapeCommFunction function (USER.214). 

Parameter Description 



cid 
fen 



Identifies the communications device. 

Specifies the extended function to carry out. It can be one of the following values. 



Value 



CLRDTR 
CLRRTS 
GETBASEIRQ 



GETMAXBAUD 



GETMAXCOM 



GETMAXLPT 

RESETDEV 

SETDTR 
SETRTS 



Meaning 



Clears the data-terminal-ready (DTR) signal. 
Clears the request-to-send (RTS) signal 
Returns the base-port address and IRQ setting for the COM port 
specified by the eid parameter. The low 16 bits of the return 
address specifies the base-port address, and the high address 
specifies the IRQ selection. If the high 16 bits is -1. then the port 
does not exist; if it is zero, the installed COMM driver does not 
support this escape. 

Returns a constant that indicates the highest baud rate supported 
by the port specified by the cid parameter. The following constants 
may be retumed. 

Value Meaning 

CBR_1 10 The highest baud rate is 1 10. 

CBR_300 The highest baud rate is 300. 

CBR_600 The highest baud rate is 600. 

CBR_1200 The highest baud rate is 1200. 

CBR_2400 The highest baud rate is 2400. 

CBR_4800 The highest baud rate is 4800. 

CBR_9600 The highest baud rate is 9600. 

CBR_1 9200 The highest baud rate is 1 9,200. 

CBR_38400 The highest baud rate is 38.400. 

CBR_56000 The highest baud rate is 56,000. 

CBRJ 28000 The highest baud rate is 128.000. 

CBR_256000 The highest baud rate is 256.000. 
Returns the maximum COM port identifier supported by the 
communications driver. This value ranges from 0x00 to 0x7F. such 
that 0x00 corresponds to COM1 , 0x01 to COM2, 0x02 to COM3, 
and so on. The communications driver included in Windows 3.1 ' 
supports COM1 through COM4, and will always return 0x03. 
Returns the maximum LPT port ID supported by the system. This 
value ranges from 0x80H to OxFFH, such that 0x80H corresponds 
to LPT1, 0x81 H to LPT2, 0x82H to LPT3. and so on. 
Resets the printer device (that is, assert the reset line) if the cid 
parameter specifies an LPT port. No function is performed if cid 
specifies a COM port. 

Sets the data-tenninal-ready (DTR) control line on. 
Sets the request-to-send (RTS) control line on. 



SETXOFF 
SETXON 



Returns 



Causes transmission to act as if an XOFF character has been 
received. 

Causes transmission to act as if an XON character has been 
received. 



This return value is zero if successful. Otherwise, it is negative if the fen parameter does not specify i 



valid function code 
Comments 

The export ordinal for this function is 9. 



If the communications driver does not export the CommWriteString function. Windovi^s 3.1 intercepts 
and adjusts the return values for the GETBASEIRQ. GETMAXBAUD GETMAXLPT and 
GETMAXCOM functions after the cextfcn function returns. 



WORD cflush(c/c/, q) 

int cid; 
int q; 

The cflush function flushes all characters from the transmit or receive queue of the SDecified 
communications device. ^ v^mcu 

Parameter Description 



Identifies the communications device. " 

q Specifies which queue to flush. If the q parameter is 1 . the function flushes the receive 

queue; if q is zero, it flushes the transmit queue. »e^eive 

Returns 

The return value is the most recent error value. 
Comments 

The export ordinal for this function is 10. 



Int CommWriteString(c/d, pbuf, size) 



int cid; 
LPSTR pbuf; 
int size; 

The CommWriteString function transmits a string of characters using the specified communications 
device. USER calls this function whenever an application calls the WriteComm function (USER.205). 

Parameter Description 

cid Identifies the communication device. 

pbuf Points to the buffer containing the bytes to write. 

size Specifies the number of bytes to write. 

Returns 

The return value is the number of bytes actually written. 
Comments 

The export ordinal for this function is 19. 

During initialization, USER checks for this function to determine whether the driver supports the 
extended functions new to Windows 3. llf the function is not present, Windows assumes that the 
dnver is a Windows 3.0 driver and makes sure that all interaction with the driver is comoatible with 
Windows 3.0. 



int csetbrk(c/d) 
int cid; 



The csetbrk function suspends character transmission and places the communications device in a 
n?oeo^?!n; ^ whenever an application calls the SetCommBreak function 

Parameter Description 

^'c/ Identifies the communications device. 

Returns 

The return value is zero if the function is successful. Otherwise, the return value is -1. 
Comments 

The export ordinal for this function is 13. 

See Also 

cclrbrk 



WORD ctx{cid, ch) 

int c/cf; 
int ch; 



The ctx functon pteces a character in a special holding variable to ensure it will be the next character 
to be transmitted. The function will return an error code if the special holding variable already contains a 

J'm^'Io oncV ^ ^ whenever an application calls the TransmitCommChar function 

(UobK-^UD). 

Parameter Description 



cid 
ch 

Returns 



Identifies the communications device. 
Specifies the character to transmit. 



The retum value is zero if the function Is successful. The return value is one of the following values if 
there is an error. ^ 

Value Meaning 



0x8000 The function received an invalid cid parameter 

0x4000 The function could not vi^rite to the parallel port or there's already a character waiting for 
immediate transmission. ^ 

Comments 

The export ordinal for this function is 6. 
See Also 



sndcom 



int EnableNotification(c/d, hWnd, wlnTn'gger, wOutTrigger) 
int cid; 

HWND hWnd; 
WORD wlnTn'ggen 
WORD wOutTrigger, 



The EnableNotification function enables or disables communications message posting When 
enabled, the driver posts the WM_COMMNOTIFY message to the specified window. USER calls this 
function when an application calls the EnableCommNotification function (USER.245). 
Parameter Description 



cid 

hWnd 
wInT rigger 
wOutTrigger 

Returns 



Identifies the communication device. 

Identifies the window to receive the WM_COMMNOTIFY message. If this parameter is 
NULL, the function disables the notification. 

Specifies the minimum number of bytes to be received in the communication device's 
input buffer before receive notification is sent 

Specifies the maximum number of bytes to remain in the communication device's 
output buffer before transmit notification is sent 



The return value is TRUE if successful. Otherwise, the retum value is FALSE. 
Comments 

The export ordinal for this function is 100. 

The WM_COMMNOTIFY message has the following parameters. 



Parameter 



Description 



wParam 

HIWORD{/para/77) 
LOWORD(/para/n) 



Specifies the communication-device identifier (the cid parameter). 
Not used; must be zero. 

Specifies the notification status. It can be one of the following values 
Valu e Meaning 



CN^EVENT 



CN_RECEIVE 



CN_TRANSMIT 



An event enabled in the communication device's event 
mask (specified by the SetCommEventn/lask function) has 
occurred. The application should call the function 
GetCommEventMask to determine what event has 
occurred, and to clear the event 

This status is sent when the communication device's event 
word changes. The application clears the appropriate event 
to ensure notification on subsequent events. 
At least wInTrigger bytes are in the communication 
device's input buffer, or at least 1 byte is in the input buffer. 
Additionally, no more have been received before the end of 
an internal timeout period. The number of bytes in the input 
buffer must be lower than wInTrigger byies before this 
message will be sent again. 

Fewer than wOutTrigger bytes remain in the 
communication device's output buffer to be transmitted. 
The number of bytes in the output buffer must exceed 
wOutTrigger bytes before this message will be sent again. 



The communication device event may be a line-status or printer eaor Applications can determine the 
cause by using the GetCommError function immediately after the GetCommEventMask function 




(USER.209). 



LPDCB getdcb(c/cy) 
int cid; 



The getdcb function retrieves the device-control block (DCB) for the specified device USER calls this 
function whenever an application calls the GetCommState function (USER.202). 
Parameter Description 



^'^ Identifies the comnnunications device. 

Returns 

The return value is a pointer to a DCB structure. 
Comments 

The export ordinal for this function is 15, 

See Also 

DCB 



WORD \n\com(lpdcb); 
DCB FAR Vpdcb; 



The Inicom function initializes the specified communications device. USER calls this function whenever 
an application calls the OpenComm function {USER.200). 

Parameter Description 

Ipdcb Points to a DCB structure. 

Returns 

The return value is zero if the function is successful. Otherwise, the return value is a nonzero (IE *) 
value if there is an error ~ 

Comments 

The export ordinal for this function is 1 . 
See Also 
trmcom, DCB 



void ReactivateOpenCommPorts(\/o/cO 



The ReactivateOpenCommPorts function reactivates open communication ports WINOLDAP 
this function to reactivate communications ports after switching back to Windows. 

Returns 

This function has no return value. 
Comments 

The export ordinal for this function is 18. 
See Also 

SuspendOpenCommPorts 



int reccom(c/d) 
int cid; 

The reccom function reads a byte from a communications device. USER calls this function whenever 
an application calls the ReadComm function (USER.204). 

Parameter Descrip tion 

cid Identifies the communications device. 

Returns 

The retum value is the byte read. Othenwise, the return value is -2 if no data is available and -1 if there 
is an error. 

Comments 

The export ordinal for this function is 4. 

See Also 

sndcom 



WORD setcom(/pdcd); 
DCB FAR *lpdcb: 



The setcom function sets a communication device to the state specified by the DCB structure USER 
calls this function whenever an application calls the SetCommState function (USER.201). 

Parameter Description 

Ipdcb Points to a DCB structure. 

Returns 

The return value is zero if the function is successful. Otherwise, it is a negative (IE_*) value if an error 
oocu rs. 

Comments 

The export ordinal for this function is 2. 

This function reinitializes all hardware and controls as defined by the Ipdcb parameter but does not 
dear transmit or receive queues. 

See Also 

DCB 



int setque(c/y, Ipqdb) 



int cid; 

qdb FAR * Ipqdb; 

The setque function sets the transmit and receive queues. USER calls this function whenever 
application calls the OpenConfim function (USER.200). 

Parameter Description 



The return value is zero if the function is successful. Othenvise, the return value is IE BADID If the cid 
parameter is not valid. 

Comnfients 

The export ordinal for this function is 3. 

See Also 

qdb 



cid 
Ipqdb 



Identifies the communications device. 
Points to a qdb structure. 



Returns 



WORD sndcom{c/d, ch) 

int cid; 
int ch; 



The sndcom function writes a byte to the specified communications device. USER calls this function 
whenever an application calls the WriteComm function (USER.205). 

Parameter Description 

C'cf Identifies the communications device. ~ 

Specifies the character to transmit. 

Returns 

th^reTan erro^ ^^'^ '^^^^ ^"^^s^"'- Otherwise, the return value is a nonzero value if 

Comments 

The export ordinal for this function is 5. 

See Also 

reccom 



WORD stacom(c/c/, cs) 
int cid; 

COMSTAT FAR *cs; 

The stacom function returns the most recent error value and copies the current status for the specified 
device to the given structure. USER calls this function whenever an application calls the 
GetConnmError function (USER.203). 

Parameter Description 

c'c/ Identifies the communications device. 

Points to a COMSTAT structure. 

Returns 

The return value is the most recent error code. 
Comments 

The export ordinal for this function is 8. 

See Also 

COMSTAT 



void SuspendOpenCommPorts(vo/cO 



The SuspendOpenCommPorts function suspends open connmunication ports. WINOLDAP uses this 
function to suspend communications ports before switching to non-Windows applications. 
Returns 

This function has no return value. 
Comments 

The export ordinal for this function is 17. 
See Also 

ReactivateOpenCommPorts 



int tnncom(c;cO 
int cid; 



The trmcom function closes the specified communications device and frees any memory allocated for 
the device's transmit and receive queues. All characters in the output queue are transmitted before the 
communications device is closed unless an error occurs. The trmcom function returns an error 
immediately if the ad parameter is not valid, and retums an error if a timeout occurs vi^hiie attempting to 
send the characters. ^ 

USER calls this function whenever an application calls the CloseComm function (USER.207). 

Parameter Description 

cid Identifies the communications device. 

Returns 

The retum value is zero if the function is successful. The function retums -2 if an error occurred while 
transmitting the remaining characters from the transmit queue. If the cid parameter is not valid trmcom 
will retum 0x8000. , »^»^^^J^n 

Comments 

The export ordinal for this function is 7. 

If the retum value is -2. the function may have left some characters in the transmit queue but may 
have successfully sent others. If an application subsequently calls the stacom through the 
GetCommError function (USER.203). the driver should set the cbOutQue member in the COMST AT 

structure to allow the application to detennine how many characters were actually transmitted! 

See Also 
inicom 



void SuspendOpenCommPorts(vo/cO 



The SuspendOpenCommPorts function suspends open communication ports. WINOLDAP uses this 
function to suspend communications ports before switching to non-Windows applications. 

Returns 

This function has no return value. 
Comments 

The export ordinal for this function is 17. 
See Also 

ReactivateOpenCommPorts 



int trniconi(c/cO 
int cid; 



The trmcom function closes the specified communications device and frees any memory allocated for 
the device's transmit and receive queues. All characters in the output queue are transmitted t)efbre the 
communications device is closed unless an error occurs. The trmcom function returns an error 
immediately if the cid parameter is not valid, and returns an error if a timeout occurs while attemotina to 
send the characters. ^ 

USER calls this function whenever an application calls the CloseComm function (USER.207). 
Parameter Description 

cid Identifies the communications device. ~ 

Returns 

The retum value is zero if the function is successful. The function returns -2 if an error occurred while 
^wirret^rn oisooo"^^'"'"^ characters from the transmit queue. If the cid parameter is not valid, trmcom 

Comments 

The export ordinal for this function is 7. 

If the retum value is -2. the function may have left some characters in the transmit queue but may 
have successfully sent others. If an application subsequently calls the stacom through the 
GetCommError function (USER.203). the driver should set the cbOutQue member in the COMSTA T 

structure to allow the application to determine how many characters were actually transmitted 

See Also 
inlcom 




typedef struct tagCOMSTAT { 

BYTE fCtsHold: 1; 

BYTE fDsrHold: 1; 

BYTE fRIsdHold: 1; 

BYTE fXoffHold: 1; 

BYTE fXoffSent: 1; 

BYTE fEof: 1; 

BYTE fTxim: 1; 

WORD cblnQue; 

WORD cbOutQue; 
} COMSTAT; 

The COMSTAT structure contains information about a communications device. 

Member Description 

Specifies whether transmission is waiting for the clear-to-send (CTS) signal to be 
sent. 

Specifies whether transmission is waiting for the data-set-ready (DSR) signal to be 
sent. 

Specifies whether transmission is waiting for the receive-line-signal-detect (RLSD) 
signal to be sent 

Specifies whether transmission is waiting as a result of the XOFF character being 
received. 

Specifies whether transmission is waiting as a result of the XOFF character being 
transmitted. Transmission halts when the XOFF character is transmitted and used 
by systems that take the next character as XON, regardless of the actual character. 
Specifies whether the end-of-file (EOF) character has been received. 

Specifies whether a character previously passed to the ctx function is waiting to be 
transmitted. 

Specifies the number of characters in the receive queue. 
Specifies the number of characters in the transmit queue. 



stacom 



fCtsHold 
fDsrHold 
fRIsdHold 
fXoffHold 
fXoffSent 

fEof 
fTxim 

CblnQue 
cbOutQue 

See Also 



7 
7 



7 



7 



typedef struct { 

char Id; r internal device ID 7 

ushort Baudrate; /* operating speed 7 
char ByteSize; /* transmit/receive byte size 7 
char Parity; r 0,1,2,3. or 4 7 
char StopBits; /* number of stop bits 7 
ushort RIsTimeout; /* timeout for RLSD to be set 
ushort CtsTimeout; /* timeout for CTS to be set 
ushort DsrTimeout; /* timeout for DSR to be set 
ushort fBinary: 1 ; /* binary-mode flag 7 
ushort fRtsDisable: 1 ; /* disable RTS 7 
ushort fParity: 1 ; /* enable parity checking 7 
ushort fDummy: 5; 

ushort fOutX: 1 ; /* enable output XON/XOFF 
ushort fInX: 1 ; /* enable input XON/XOFF 7 
ushort fPeChar 1; /* enable parity-error replacement 
ushort fNull: 1 ; r enable null stripping 7 
ushort fChEvt: 1 ; /* enable Rx character event 7 
ushort fDtrflow: 1 ; T enable DTR f\ov^ control 7 
ushort fRtsflow: 1 ; /* enable RTS flow control 7 
ushort fDummy2: 1; 
char XonChan 
char XoffChar, 
ushort XonLim; 
ushort XoffLim; 
char PeChar; 
char EofChar; 
char EvtChar; 
ushort TxDelay; 
}DCB; 

The DCB structure contains the RS-232 configuration parameters for a communication device. 

Member Descriptio n 

Id 



7 
7 



/* transmit/receive XON character 
/* transmit/receive XOFF character 

r transmit XON threshold 7 
/* transmit XOFF threshold 7 
/* parity en-or replacement character 7 
/* end-of-input character 7 
/* event-generating character 7 

/* amount of time between characters 7 



Baudrate 
ByteSize 
Parity 



Specifies the device ID byte {C0M1 = 0. COM2 = 1, and so on). This is also the 
value returned by the cOpen function, when successful. 
Specifies the operating speed; any baud rate supported by the hardware. 
Specifies the transmitting and receiving byte size; nomially in the range 4 through 8. 
Specifies the parity setting. The value can be one of the following values. 
Value Meaning 



0 
1 
2 
3 
4 



None 

Odd 

Even 

Mari< 

Space 



StopBits 



Specifies the number of stop bits. The value can be one of the following values. 
Value Meaning 



RIsTimeout 



0 1 stop bit 

1 1.5 stop bits 

2 2 stop bits 

Specifies the amount of time, in milliseconds, to wait for receiving-line-signal detect 



CtsTimeout 
DsrTimeout 
fBinary 
fRtsOisable 



fParity 
fOutX 



fInX 

fPeChar 

fNull 
fChEvt 

fDtrFlow 

fRtsflow 

XonChar 
XoffChar 
XonLim 

XoffLim 

PeChar 
EofChar 
EvtChar 
TxDelay 

See Also 



(RLSD) to become high. RLSD flow control can be achieved by specifyinq infinite 
timeout (OxFFFF). 

Specifies the amount of time, in milliseconds, to wait for clear-to-send signal (CTS) 
to become high. CTS flow control can be achieved by specifying infinite timeout 
(OxFFFF). 

Specifies the amount of time, in milliseconds, to wait for data-set-ready (DSR) to 
become high. DSR flow control can be achieved by specifying infinite timeout 
(OxFFFF). 

Specifies the binary-mode flag (0 is ASCII mode. 1 is binary). In ASCII mode, the 
end-of-file character (EOFCHAR) is recognized and remembered as the end of 
received data. 

Disables the receive-transmission signal (RTS) line for as long as this device is 
open, if set. Normally. RTS is enabled when the device is opened and disabled when 
closed. 

Enables parity checking, if set. 

Indicates that XON/XOFF flow control is to be used during transmission, if set. The 
transmitter halts when it receives an XOFF character, and starts again when it 
receives an XON character. 

Indicates that XON/XOFF flow control is to be used during reception, if set 
Indicates that characters received with parity errors are to be replaced with the 
specified parity-checking characters (PECHAR). if set. 
Specifies that the received null characters are to be discarded, if set 

Indicates that the reception of event-checking characters (EVTCHAR) are to be 
flagged as an event, if set 

Indicates that the data-terminal-ready signal (DTR) is to be used for receive flow 
control, if set 

Indicates that the receive-transmission signal (RTS) is to be used for receive flow 
control, if set. 

Specifies the XON character for both transmit and receive. 
Specifies the XOFF character for both transmit and receive. 
Specifies the threshold value for receive queue. When the receive queue comes 
within 10 characters of being full, it transmits an XOFF character. When the queue 
comes within 10 characters of being empty, an XON character will be transmitted. 
Specifies the threshold value for send queue. When the number of characters in the 
receive queue exceeds this value, an XOFF character is sent (if XOFF flow control is 
enabled) and the data-terminal-ready signal (DTR) is dropped (if enabled). 
Specifies the character to be used as replacement when a parity error occurs. 
Specifies the character that signals the end of the input 
Specifies the character that triggers an event flag. 

Specifies the minimum amount of time that must pass between transmission of 
characters. 



getdcb. inicom, setcom 



typedef struct { 

char far *pqRx; /* pointer to Rx queue 7 

int cbqRx; /* size of Rx queue in bytes */ 

char far *pqTx; /* pointer to Tx queue 7 

int cbqTx; /* size of Tx queue in bytes 7 
}qdb; 

The qdb structure contains infonnation about the location and size of the transmit and receive queues. 

Member Description 

pqRx Points to the receive queue. 

cbqRx Specifies the size (in bytes) of the receive queue, 

pqTx Points to the transmit queue. 

cbqTx Specifies the size (in bytes) of the transmit queue. 

See Also 

setque 



